home *** CD-ROM | disk | FTP | other *** search
/ Amiga Format CD 43 / Amiga Format CD43 (1999)(Future Publishing)(GB)(Track 1 of 2)[!][issue 1999-09].iso / -serious- / programming / mui / mcc_pkb / mcc_pkb_czech.lha / MCC_Pkb.doc
Text File  |  1999-03-24  |  11KB  |  491 lines
  1. TABLE OF CONTENTS
  2.  
  3. Pkb.mcc/Pkb.mcc
  4. Pkb.mcc/MUIA_Pkb_Mode
  5. Pkb.mcc/MUIA_Pkb_AutoRelease
  6. Pkb.mcc/MUIA_Pkb_Current
  7. Pkb.mcc/MUIA_Pkb_Quiet
  8. Pkb.mcc/MUIA_Pkb_Pool
  9. Pkb.mcc/MUIA_Pkb_PoolPuddleSize
  10. Pkb.mcc/MUIA_Pkb_PoolThreshSize
  11. Pkb.mcc/MUIA_Pkb_Octv_Name
  12. Pkb.mcc/MUIA_Pkb_Octv_Base
  13. Pkb.mcc/MUIA_Pkb_Octv_Range
  14. Pkb.mcc/MUIA_Pkb_Octv_Start
  15. Pkb.mcc/MUIA_Pkb_Key_Release
  16. Pkb.mcc/MUIA_Pkb_Key_Press
  17. Pkb.mcc/MUIA_Pkb_Range_Head
  18. Pkb.mcc/MUIA_Pkb_Range_Start
  19. Pkb.mcc/MUIA_Pkb_Range_End
  20. Pkb.mcc/MUIA_Pkb_Low
  21. Pkb.mcc/MUIA_Pkb_High
  22. Pkb.mcc/MUIM_Pkb_Reset
  23. Pkb.mcc/MUIM_Pkb_Refresh
  24. Pkb.mcc/MUIM_Pkb_Range
  25. Pkb.mcc/MUIM_Pkb_Range_Reset
  26. Pkb.mcc/MUIM_Pkb_Range_Refresh
  27. Pkb.mcc/MUIM_Pkb_Jump
  28. Pkb.mcc/MUIA_Pkb_InputEnable
  29. Pkb.mcc/MUIA_Pkb_ExcludeLow
  30. Pkb.mcc/MUIA_Pkb_ExcludeHigh
  31. Pkb.mcc/Pkb.mcc
  32.  
  33.    Pkb je tÒÉda balÉku Magic User Interface © od Stefana Stuntze.
  34.    Je to podtÒÉda tÒÉdy Virtgroup.
  35.  
  36.    CÉlem t×to tÒÉdy je poskytnutÉ klÁvesnice piÁna pro rÊzn× hudebnÉ
  37.    aplikace.
  38.  
  39.    Pkb vyuÚÉvÁ rÊzn× barvy pro rÊzn× pracovnÉ mÏdy, kter× mohou bÙt
  40.    kter× mohou bÙt zmÅnÅny uÚivatelem pomocÉ MCP.
  41.  
  42.    ProsÉm, podÉvejte se na program, kterÙ je pÒiloÚenÙ jako pÒÉklad,
  43.    pro bliÚÓÉ detaily.
  44.  
  45.    Demo mÊÚe bÙ kompilovÁno pomocÉ Dice nebo StormC 2.0.
  46.  
  47. POZNáMKY
  48.    ZatÉm ÚÁdn×.
  49.  
  50. Pkb.mcc/MUIA_Pkb_Mode
  51.  
  52. JM÷NO
  53.    MUIA_Pkb_Mode   -- (V14.3) [ISG], ULONG
  54.  
  55. FUNKCE
  56.    NastavenÉ nebo vrÁcenÉ operaÃnÉho mÏdu klÁvesnice.
  57.  
  58. VSTUPY
  59.    MUIV_Pkb_Mode_NORMAL   (zÁkladnÉ)
  60.    MUIV_Pkb_Mode_SPECIAL
  61.    MUIV_Pkb_Mode_RANGE
  62.  
  63. POZNáMKY
  64.    PrvnÉ dva mÏdy se liÓÉ pouze v barevn× reprezantaci stisknutÙch klÁves.
  65.  
  66.    TÒetÉ mÏd je pouÚit na oznaÃenÉ skupiny klÁves.
  67.    MUIA_Pkb_Range_Start a MUIA_Pkb_Range_End atributy reprezentujÉ
  68.    poÃÁteÃnÉ a koncovou kÁvesu POSLEDNå zvolen×ho rozsahu.
  69.    V tomto mÏdu nenÉ nastaven MUIA_Pkb_Key_Release atribut v pÒÉpadÅ,
  70.    Úe uÚivatel pustÉ tlaÃÉtko myÓi na poslednÉ klÁvese.
  71.  
  72. REFERENCE
  73.    MUIA_Pkb_Range_Head
  74.  
  75. Pkb.mcc/MUIA_Pkb_AutoRelease
  76.  
  77. NáZEV
  78.    MUIA_Pkb_AutoRelease   -- (V14.3) [ISG], BOOL
  79.  
  80. FUNKCE
  81.    NastavenÉ nebo detekce automatick×ho uvolnÅnÉ klÁvesy.
  82.  
  83. VSTUPY
  84.    -TRUE  (zÁkladnÉ)
  85.    -FALSE
  86.  
  87. POZNáMKY
  88.    JestliÚe je TRUE, klÁvesa je uvolnÅna a uÚivatel mÊÚe stisknout jinou
  89.    klÁvesu.
  90.    JestliÚe je FALSE, klÁvesa nenÉ uvolnÅna a jejÉ uvolnÅnÉ zÁvisÉ
  91.    na aplikaci.
  92.  
  93. REFERENCE
  94.    MUIA_Pkb_Key_Press , MUIA_Pkb_Key_Release
  95.  
  96. Pkb.mcc/MUIA_Pkb_Current
  97.  
  98. NáZEV
  99.     MUIA_Pkb_Current   -- (V14.3) [..GN], LONG
  100.  
  101. FUNKCE
  102.    Detekuje kÏd poslednÉ hran× noty (poslednÉ stisknut× klÁvesy) uÚivatelem
  103.  
  104. POZNáMKY
  105.    NÁvratovÁ hodnota je v rozsahu 0 aÚ 131 a je nezÁvislÁ na poÃtu oktÁv,
  106.    kter× mohou bÙt zobrazeny na hornÉ liÓtÅ.
  107.  
  108. REFERENCE
  109.    MUIA_Pkb_Octv_Start, MUIA_Pkb_Octv_Range, MUIA_Pkb_Key_Release
  110.  
  111. Pkb.mcc/MUIA_Pkb_Quiet
  112.  
  113. NáZEV
  114.    MUIA_Pkb_Quiet   -- (V14.3) [.S.], BOOL
  115.  
  116. FUNKCE
  117.    JestliÚe je nastaven na TRUE, ÚÁdn× klavesy nelze zmÁÃknout.
  118.  
  119. REFERENCE
  120.     MUIM_Pkb_Refresh
  121.  
  122. Pkb.mcc/MUIA_Pkb_Pool
  123.  
  124. NáZEV
  125.    MUIA_Pkb_Pool   -- (V14.3) [I.G], PoolHeader *
  126.  
  127. FUNKCE
  128.    PodÁ nÅkterÁ data z CreatePool(), jestliÚe nechcete vytvoÒit tabulku
  129.    ve vlastnÉ oblasti pamÅti, ale z jiÚ alokovan×. Pkb tÒÉda NEPOUúéVá
  130.    protekci semaforÊ pÒi pÒÉstupu do oblasti pamÅti. NESMéTE pouÚÉt
  131.    oblasti pamÅti, kter× jsou pÒÉstupn× jinÙm procesÊm neÚ hlavnÉmu
  132.    procesu programu.
  133.  
  134. REFERENCE
  135.     MUIA_Pkb_PoolPuddleSize, MUIA_Pkb_PoolThreshSize
  136.  
  137. Pkb.mcc/MUIA_Pkb_PoolPuddleSize
  138.  
  139. NáZEV
  140.    MUIA_Pkb_PoolPuddleSize   -- (V14.3) [I..], ULONG
  141.  
  142. FUNKCE
  143.    Specifikuje velikost pro tabulku oblasti pamÅti.
  144.  
  145.    ZÁkladnÉ hodnota je 2048. Tato hodnota je ignorovÁna, jestliÚe
  146.    specifikujete vlastnÉ oblast pomocÉ MUIA_Pkb_Pool.
  147.  
  148. REFERENCE
  149.     MUIA_Pkb_Pool, MUIA_Pkb_PoolThreshSize
  150.  
  151. Pkb.mcc/MUIA_Pkb_PoolThreshSize
  152.  
  153. NáZEV
  154.    MUIA_Pkb_PoolThreshSize   -- (V14.3) [I..], ULONG
  155.  
  156. FUNKCE
  157.     Specifikuje velikost prahu pro tabulku oblasti pamÅti.
  158.  
  159.     ZÁkladnÉ nastavenÉ je 1024. Tato hodnota je ignorovÁna,
  160.     jestliÚe specifikujete vlastnÉ oblast pomocÉ MUIA_Pkb_Pool.
  161.  
  162. REFERENCE
  163.     MUIA_Pkb_Pool, MUIA_Pkb_PoolPuddleSize
  164.  
  165. Pkb.mcc/MUIA_Pkb_Octv_Name
  166.  
  167. NáZEV
  168.    MUIA_Pkb_Octv_Name   -- (V14.3) [I..], BOOL
  169.  
  170. FUNKCE
  171.    Indikuje, kterÁ liÓta se zobrazÉ nad klÁvesnicÉ.
  172.  
  173. REFERENCE
  174.  
  175.  
  176. Pkb.mcc/MUIA_Pkb_Octv_Base
  177.  
  178. NáZEV
  179.    MUIA_Pkb_Octv_Base   -- (V14.3) [I..], LONG
  180.  
  181. FUNKCE
  182.    Indikuje poÃÁteÃnÉ ÃÉslo, kter× se zobrazÉ na liÓtÅ nad klÁvesnicÉ.
  183.  
  184. POZNáMKY
  185.    VarovÁnÉ: kÏdy klÁves NEJSOU ovlivnÅny ÃÉslem oktÁvy zobrazen×
  186.    na liÓtÅ.
  187.  
  188. REFERENCE
  189.     MUIA_Pkb_Octv_Name
  190.  
  191. Pkb.mcc/MUIA_Pkb_Octv_Range
  192.  
  193. NáZEV
  194.    MUIA_Pkb_Octv_Range   -- (V14.3) [I...], ULONG
  195.  
  196. FUNKCE
  197.    Indikuje, kolik oktÁv bude zobrazeno na klÁvesnici.
  198.    MoÚn× hodnoty: 1...11
  199.  
  200. REFERENCE
  201.  
  202.  
  203. Pkb.mcc/MUIA_Pkb_Octv_Start
  204.  
  205. NáZEV
  206.    MUIA_Pkb_Octv_Start   -- (V14.3) [I.G], ULONG
  207.  
  208. FUNKCE
  209.    Indikuje poÃÁteÃnÉ oktÁvu pro klÁvesnici.
  210.  
  211. POZNáMKY
  212.    VarovÁnÉ: MUIA_Pkb_Octv_Start + MUIA_Pkb_Octv_Range MUSé bÙt <= 11,
  213.    jinak MUIA_Pkb_Octv_Start bude automaticky sniÚovÁno, dokud nebude
  214.    platit podmÉnka.
  215.  
  216. REFERENCE
  217.  
  218.  
  219. Pkb.mcc/MUIA_Pkb_Key_Release
  220.  
  221. NáZEV
  222.     MUIA_Pkb_Key_Release   -- (V14.3) [.S.N], ULONG
  223.  
  224. FUNKCE
  225.    UvolnÅnÉ klÁvesy.
  226.  
  227. POZNáMKY
  228.    Rozsah kÏdu klÁves mezi 0 a 131 nenÉ zÁvislÙ na ÃÉsle oktÁvy,
  229.    kter× je zobrazeno na hornÉ liÓtÅ.
  230.  
  231. REFERENCE
  232.    MUIA_Pkb_Octv_Start, MUIA_Pkb_Octv_Range, MUIA_Pkb_Key_Press
  233.  
  234. Pkb.mcc/MUIA_Pkb_Key_Press
  235.  
  236. NáZEV
  237.     MUIA_Pkb_Key_Press   -- (V14.3) [.S..], ULONG
  238.  
  239. FUNKCE
  240.    StisknutÁ klÁvesa.
  241.  
  242. POZNáMKY
  243.    Rozsah kÏdu klÁves mezi 0 a 131 nenÉ zÁvislÙ na ÃÉsle oktÁvy,
  244.    kter× je zobrazeno na hornÉ liÓtÅ.
  245.  
  246. REFERENCE
  247.    MUIA_Pkb_Octv_Start, MUIA_Pkb_Octv_Range, MUIA_Pkb_Key_Release
  248.  
  249. Pkb.mcc/MUIA_Pkb_Range_Head
  250.  
  251. NáZEV
  252.    MUIA_Pkb_Range_Head   -- (V14.3) [.SGM], ULONG
  253.  
  254. FUNKCE
  255.    NastavenÉ nebo vrÁcenÉ skupiny v mÏdu oznaÃenÉ rozsahu.
  256.  
  257. VSTUPY
  258.    MUIV_Pkb_Range_Head_OFF
  259.    MUIV_Pkb_Range_Head_BOT
  260.    MUIV_Pkb_Range_Head_TOP
  261.  
  262. REFERENCE
  263.    MUIA_Pkb_Mode
  264.  
  265. Pkb.mcc/MUIA_Pkb_Range_Start
  266.  
  267. NáZEV
  268.    MUIA_Pkb_Range_Start   -- (V14.3) [.SGM], LONG
  269.  
  270. FUNKCE
  271.    NastavenÉ nebo vrÁcenÉ kÏdu nejniÚÓÉ noty v poslednÉm aktivnÉm rozsahu.
  272.  
  273. POZNáMKY
  274.    PÒi nastavovÁnÉ by hodnota mÅla bÙt kladnÁ.
  275.  
  276.    PÒi zjiÓÔovÁnÉ hodnoty tento atribut vÚdy vracÉ hodnotu mezi 0 a 131
  277.    nebo -1, jestliÚe nenÉ zvolen ÚÁdnÙ rozsah.
  278.  
  279. REFERENCE
  280.    MUIA_Pkb_Range_End, MUIA_Pkb_Mode
  281.  
  282. Pkb.mcc/MUIA_Pkb_Range_End
  283.  
  284. NáZEV
  285.    MUIA_Pkb_Range_End   -- (V14.3) [.SGM], LONG
  286.  
  287. FUNKCE
  288.    NastavenÉ nebo vrÁcenÉ kÏdu nejvyÓÓÉ noty v poslednÉm aktivnÉm rozsahu.
  289.  
  290. POZNáMKY
  291.    PÒi nastavovÁnÉ by hodnota mÅla bÙt kladnÁ.
  292.  
  293.    PÒi zjiÓÔovÁnÉ hodnoty tento atribut vÚdy vracÉ hodnotu mezi 0 a 131
  294.    nebo -1, jestliÚe nenÉ zvolen ÚÁdnÙ rozsah.
  295.  
  296. REFERENCE
  297.    MUIA_Pkb_Range_Start, MUIA_Pkb_Mode
  298.  
  299. Pkb.mcc/MUIA_Pkb_Low
  300.  
  301. NáZEV
  302.    MUIA_Pkb_Low   -- (V14.3) [..G.], ULONG
  303.  
  304. FUNKCE
  305.    VracÉ kÏd nejniÚÓÉ noty klÁvesnice.
  306.  
  307. REFERENCE
  308.    MUIA_Pkb_High
  309.  
  310. Pkb.mcc/MUIA_Pkb_High
  311.  
  312. NáZEV
  313.    MUIA_Pkb_High   -- (V14.3) [..G.], ULONG
  314.  
  315. FUNKCE
  316.    VracÉ kÏd nejvyÓÓÉ noty klÁvesnice.
  317.  
  318. REFERENCE
  319.    MUIA_Pkb_Low
  320.  
  321. Pkb.mcc/MUIM_Pkb_Reset
  322.  
  323. NáZEV
  324.    MUIM_Pkb_Reset
  325.  
  326. POUúITé
  327.    DoMethod(obj, MUIM_Pkb_Reset);
  328.  
  329. FUNKCE
  330.    Resetuje klÁvesnici uvolnÅnÉm vÓech klÁves.
  331.  
  332. REFERENCE
  333.  
  334.  
  335. Pkb.mcc/MUIM_Pkb_Refresh
  336.  
  337. NáZEV
  338.    MUIM_Pkb_Refresh  -- (V14.3)
  339.  
  340. POUúITé
  341.    DoMethod(obj, MUIM_Pkb_Refresh);
  342.  
  343. FUNKCE
  344.    ObnovÉ klÁvesnici.
  345.  
  346. POZNáMKY
  347.    Tato metoda mÊÚe bÙt pouÚita v pÒÉpadÅ, Úe doÓlo k nÅkterÙm zmÅnÁm
  348.    pÒi nastaven×m atributu MUIA_Pkb_Quiet na hodnotu TRUE.
  349.  
  350. REFERENCE
  351.    MUIA_Pkb_Quiet
  352.  
  353. Pkb.mcc/MUIM_Pkb_Range
  354.  
  355. NáZEV
  356.    MUIM_Pkb_Range  -- (V14.3)
  357.  
  358. POUúITé
  359.    DoMethod(obj, MUIM_Pkb_Range, ULONG nstart, ULONG nend);
  360.  
  361. FUNKCE
  362.    VytvoÒÉ rozsah mezi hodnotami nstart a nend.
  363.  
  364. POZNáMKY
  365.    Hodnota nstart nemusÉ bÙt menÓÉ neÚ hodnota nend, ale obÅ hodnoty musÉ bÙt
  366.    v rozsahu hodnot 0...131.
  367.  
  368. REFERENCE
  369.    MUIA_Pkb_Range_Start, MUIA_Pkb_Range_End
  370.  
  371. Pkb.mcc/MUIM_Pkb_Range_Reset
  372.  
  373. NáZEV
  374.    MUIM_Pkb_Range_Reset  -- (V14.3)
  375.  
  376. POUúITé
  377.    DoMethod(obj, MUIM_Pkb_Range_Reset);
  378.  
  379. FUNKCE
  380.    Resetuje poslednÉ aktvinÉ rozsah tak, Úe uvolnÉ vÓechny klÁvesy,
  381.    kter× do rozsahu patÒÉ.
  382.  
  383. POZNáMKY
  384.    Po volÁnÉ t×to metody MUIA_Pkb_Range_Start a MUIA_Pkb_Range_End atributy
  385.    jsou resetovÁny.
  386.  
  387. REFERENCE
  388.    MUIA_Pkb_Range_Start, MUIA_Pkb_Range_End
  389.  
  390. Pkb.mcc/MUIM_Pkb_Range_Refresh
  391.  
  392. NáZEV
  393.    MUIM_Pkb_Range_Refresh  -- (V14.3)
  394.  
  395. POUúITé
  396.    DoMethod(obj, MUIM_Pkb_Range_Refresh);
  397.  
  398. FUNKCE
  399.    ObnovÉ aktivnÉ rozsah, a to takovou skupinu not, kterÁ leÚÉ mezi hodnotami
  400.    MUIA_Pkb_Range_Start a MUIA_Pkb_Range_End.
  401.  
  402. REFERENCE
  403.    MUIA_Pkb_Range_Start, MUIA_Pkb_Range_End
  404.  
  405. Pkb.mcc/MUIM_Pkb_Jump
  406.  
  407. NáZEV
  408.    MUIM_Pkb_Jump  -- (V14.3)
  409.  
  410. POUúITé
  411.    DoMethod(obj, MUIM_Pkb_Jump, ULONG ncode);
  412.  
  413. FUNKCE
  414.    SkoÃÉ na notu, reprezentujÉcÉ kÏd ncode, coÚ znamenÁ, Úe ji uÃinÉ
  415.    viditelnou.
  416.  
  417. POZNáMKY
  418.    Hodnota ncode musÉ bÙt nezbytnÅ uvnitÒ rozsahu klÁvesnice, dan× hodnotami
  419.    MUIA_Pkb_Low a MUIA_Pkb_High.
  420.  
  421. REFERENCE
  422.    MUIA_Pkb_Range_Start, MUIA_Pkb_Range_End
  423.  
  424. Pkb.mcc/MUIA_Pkb_InputEnable
  425.  
  426. NáZEV
  427.    MUIA_Pkb_InputEnable   -- (V14.4) [ISG], BOOL
  428.  
  429. FUNKCE
  430.    PovolÉ nebo zakÁÚe moÚnost interakce s klÁvesnicÉ.
  431.  
  432. VSTUPY
  433.    TRUE   (zÁkladnÉ)
  434.    FALSE
  435.  
  436. POZNáMKY
  437.      PouÚijte tento atribut, jestliÚe nechcete, aby klÁvesnice reagovala
  438.      na jak×koli stisknutÉ jak×koli klÁvesy, coÚ znamenÁ, Úe nebudou
  439.      posÉlÁny jak×koli udÁlosti.
  440.  
  441.      JestliÚe nastavÉte MUIA_Pkb_Quiet na TRUE, klÁvesnice bude vypadat,
  442.      Úe nereaguje, protoÚe nebudou obnovovÁny klÁvesy, ale atributy, zÁvisejÉcÉ
  443.      na stisku nebo uvolnÅnÉ klÁvesy (jako napÒ. MUIA_Pkb_Key_Release,
  444.      MUIA_Pkb_Key_Press atd.) budou aktualizovÁny.
  445.  
  446. REFERENCE
  447.    MUIA_Pkb_Quiet
  448.  
  449. Pkb.mcc/MUIA_Pkb_ExcludeLow
  450.  
  451. NáZEV
  452.    MUIA_Pkb_ExcludeLow   -- (V14.4) [ISG], ULONG
  453.  
  454. FUNKCE
  455.    NastavÉ nebo vrÁtÉ poÃet pÊltÏnÊ vyjmut× z nejniÚÓÉ ÃÁsti klÁvesnice. 
  456.  
  457. VSTUPY
  458.         0 : nebudou vylouÃeny ÚÁdn× klÁvesy (zÁkladnÉ stav)
  459.    1...11 : vylouÃenÉ C...Bb
  460.  
  461. POZNáMKY
  462.    TÒÉda Pkb NEMêúE vykreslovat nekompletnÉ oktÁvy
  463.    JenÚe, nÅkdy potÒebujete mÉt klÁvesnici, kterÁ zaÃÉnÁ notou rÊznou od typick×ho C.
  464.    To lze udÅlat tak, Úe pÒiÒadÉte MUIA_Pkb_ExcludeLow adekvÁtnÉ poÃet pÊltÏnÊ.
  465.    VylouÃen× klÁvesy se sice zobrazÉ, ale budou mÉt jinou barvu a nebudou reagovat.
  466.  
  467. REFERENCE
  468.    MUIA_Pkb_ExcludeHigh
  469.  
  470. Pkb.mcc/MUIA_Pkb_ExcludeHigh
  471.  
  472. NáZEV
  473.    MUIA_Pkb_ExcludeHigh   -- (V14.4) [ISG], ULONG
  474.  
  475. FUNKCE
  476.    NastavÉ nebo vrÁtÉ poÃet pÊltÏnÊ vyjmut× z nejvyÓÓÉ ÃÁsti klÁvesnice.
  477.  
  478. VSTUPY
  479.         0 : ÚÁdn× klÁvesy nejsou vylouÃeny  (zÁkladnÉ stav)
  480.    1...11 : vylouÃenÉ B...Db
  481.  
  482. POZNáMKY
  483.    TÒÉda Pkb NEMêúE vykreslovat nekompletnÉ oktÁvy
  484.    JenÚe, nÅkdy potÒebujete mÉt klÁvesnici, kterÁ konÃÉ notou rÊznou od typick×ho B.
  485.    To lze udÅlat tak, Úe pÒiÒadÉte MUIA_Pkb_ExcludeHigh adekvÁtnÉ poÃet pÊltÏnÊ.
  486.    VylouÃen× klÁvesy se sice zobrazÉ, ale budou mÉt jinou barvu a nebudou reagovat.
  487.  
  488. REFERENCE
  489.    MUIA_Pkb_ExcludeLow
  490.  
  491.